home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / windownt / awksrc.zip / README < prev    next >
Text File  |  1992-11-05  |  4KB  |  117 lines
  1. README:
  2.  
  3. This is GNU Awk 2.14. It should be upwardly compatible with the
  4. System V Release 4 awk.  It is almost completely compliant with draft 11.3
  5. of POSIX 1003.2.
  6.  
  7. This release is essentially a bug fix release.
  8.  
  9. See the installation instructions, below.
  10.  
  11. Known problems are given in the PROBLEMS file.  Work to be done is
  12. described briefly in the FUTURES file.  Verified ports are listed in
  13. the PORTS file.  Changes in this version are summarized in the CHANGES file.
  14. Please read the LIMITATIONS and ACKNOWLEDGMENT files.
  15.  
  16. Read the file POSIX for a discussion of how the standard says comparisons
  17. should be done vs. how they really should be done and how gawk does them.
  18.   
  19. To format the documentation with TeX, you must use texinfo.tex 2.53
  20. or later.  Otherwise footnotes look unacceptable.
  21.  
  22. If you wish to remake the Info files, you should use makeinfo. The 2.15 
  23. version of makeinfo works with no errors.
  24.  
  25. The man page is up to date.
  26.  
  27. INSTALLATION:
  28.  
  29. Check whether there is a system-specific README file for your system.
  30.  
  31. Makefile.in may need some tailoring.  The only changes necessary should
  32. be to change installation targets or to change compiler flags.
  33. The changes to make in Makefile.in are commented and should be obvious.
  34.  
  35. All other changes should be made in a config file.  Samples for
  36. various systems are included in the config directory.  Starting with
  37. 2.11, our intent has been to make the code conform to standards (ANSI,
  38. POSIX, SVID, in that order) whenever possible, and to not penalize
  39. standard conforming systems.  We have included substitute versions of
  40. routines not universally available.  Simply add the appropriate define
  41. for the missing feature(s) on your system.
  42.  
  43. If you have neither bison nor yacc, use the awktab.c file here.  It was
  44. generated with bison, and should have no AT&T code in it.  (Note that
  45. modifying awk.y without bison or yacc will be difficult, at best.  You might
  46. want to get a copy of bison from the FSF too.)
  47.  
  48. If no config file is included for your system,  start by copying one
  49. for a similar system.  One way of determining the defines needed is to
  50. try to load gawk with nothing defined and see what routines are
  51. unresolved by the loader.  This should give you a good idea of how to
  52. proceed.
  53.  
  54. The next release will use the FSF autoconfig program, so we are no longer 
  55. soliciting new config files.
  56.  
  57. If you have an MS-DOS system, use the stuff in the pc directory.
  58. For an Atari there is an atari directory and similarly one for VMS.
  59.  
  60. Chapter 16 of The GAWK Manual discusses configuration in detail.
  61.  
  62. After successful compilation, do 'make test' to run a small test
  63. suite.  There should be no output from the 'cmp' invocations except in
  64. the cases where there are small differences in floating point values.
  65. If there are other differences, please investigate and report the
  66. problem.  More extensive testing can be invoked with 'make bigtest'.
  67.  
  68. PRINTING THE MANUAL
  69.  
  70. The 'support' directory contains texinfo.tex 2.65, which will be necessary
  71. for printing the manual, and the texindex.c program from the texinfo
  72. distribution which is also necessary.  See the makefile for the steps needed
  73. to get a DVI file from the manual.
  74.  
  75. CAVEATS
  76.  
  77. The existence of a patchlevel.h file does *N*O*T* imply a commitment on
  78. our part to issue bug fixes or patches.  It is there in case we should
  79. decide to do so.
  80.  
  81. BUG REPORTS AND FIXES (Un*x systems):
  82.  
  83. Please coordinate changes through David Trueman and/or Arnold Robbins.
  84.  
  85. David Trueman
  86. Department of Mathematics, Statistics and Computing Science,
  87. Dalhousie University, Halifax, Nova Scotia, Canada
  88.  
  89. UUCP:        {uunet utai watmath}!dalcs!david
  90. INTERNET:    david@cs.dal.ca
  91.  
  92. Arnold Robbins
  93. 1736 Reindeer Drive
  94. Atlanta, GA, 30329, USA
  95.  
  96. INTERNET:    arnold@skeeve.atl.ga.us
  97. UUCP:        { gatech, emory, emoryu1 }!skeeve!arnold
  98.  
  99. BUG REPORTS AND FIXES (non-Unix ports):
  100.  
  101. MS-DOS:
  102.     Scott Deifik
  103.     AMGEN Inc.
  104.     Amgen Center, Bldg.17-Dept.393
  105.     Thousand Oaks, CA  91320-1789
  106.     Tel-805-499-5725  ext.4677
  107.     Fax-805-498-0358
  108.     scottd@amgen.com
  109.  
  110. VMS:
  111.     Pat Rankin
  112.     rankin@eql.caltech.edu (e-mail only)
  113.  
  114. Atari ST:
  115.     Michal Jaegermann
  116.     NTOMCZAK@vm.ucs.UAlberta.CA  (e-mail only)
  117.